איך להוסיף צ'אטבוט AI של Asyntai ל-Backdrop CMS

מדריך צעד אחר צעד לאתרי Backdrop CMS

פלטפורמה:

שלב 1: קבל את קוד ההטמעה שלך

ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

הערה: הקוד למעלה הוא רק דוגמה. עליך להעתיק את קוד ההטמעה הייחודי שלך מלוח הבקרה שלך כיוון שהוא מכיל את מזהה הווידג'ט האישי שלך.

שלב 2: הוסף לתבנית הנושא (מומלץ)

Backdrop CMS משתמש בקבצי תבנית .tpl.php בנושאים שלו. הגישה המומלצת היא להוסיף את קוד ההטמעה ישירות לתבנית הדף של הנושא הפעיל שלך:

גש להתקנת Backdrop CMS שלך דרך FTP או מנהל קבצים
נווט לתיקיית הנושא הפעיל שלך: themes/yourtheme/
פתח את קובץ page.tpl.php (או layout.tpl.php בהתאם לנושא שלך)
מצא את תג הסגירה </body> או את השורה <?php print $page_bottom; ?>
הדבק את קוד ההטמעה של Asyntai ממש לפני שורה זו
שמור את הקובץ

<!-- Asyntai AI Chatbot -->
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
<?php print $page_bottom; ?>
</body>

טיפ: הצבת הקוד ממש לפני <?php print $page_bottom; ?> או תג הסגירה </body> מבטיחה שהצ'אטבוט ייטען אחרי תוכן הדף, ומספקת ביצועי טעינת דף טובים יותר. שיטה זו מוסיפה אוטומטית את הצ'אטבוט לכל דף שמשתמש בנושא זה.

שיטה חלופית 1: שימוש במודול מותאם אישית

אתה יכול ליצור מודול Backdrop CMS פשוט שמזריק את סקריפט הצ'אטבוט באמצעות backdrop_add_js():

צור את תיקיית המודול: modules/custom/asyntai_widget/
צור את קובץ המודול asyntai_widget.module עם הקוד הבא:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
צור את קובץ asyntai_widget.info:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
עבור ל-Functionality (admin/modules) בפאנל הניהול של Backdrop
מצא את "Asyntai AI Chatbot Widget" תחת חבילת Custom והפעל אותו
לחץ על "Save configuration"

הערה: החלף את YOUR_WIDGET_ID בקוד המודול עם מזהה הווידג'ט האמיתי שלך מלוח הבקרה של Asyntai. גישת המודול המותאם אישית בטוחה לשדרוג ולא תידרס בעת עדכון הנושא.

שיטה חלופית 2: שימוש במודול "Add to Head" של Backdrop

המודול התורם "Add to Head" מספק דרך קלה להזריק סקריפטים ללא עריכת קוד:

הורד והתקן את המודול התורם "Add to Head" מאתר Backdrop CMS
עבור ל-Configuration > Development > Add to Head
הוסף את קוד ההטמעה של Asyntai בחלק התחתון
לחץ על "Save configuration"

טיפ: שימוש במודול "Add to Head" היא השיטה הקלה ביותר אם אתה מעדיף לא לערוך קבצי נושא או ליצור מודולים מותאמים אישית. היא מספקת ממשק ניהול פשוט לניהול סקריפטים מוזרקים.

שיטה חלופית 3: שימוש במערכת בלוקים

מערכת הפריסה והבלוקים של Backdrop CMS יכולה גם היא לשמש להוספת הצ'אטבוט:

התחבר לפאנל הניהול של Backdrop CMS
עבור ל-Structure > Layouts
בחר את הפריסה שברצונך לערוך (למשל, פריסת ברירת המחדל)
לחץ על "Add block" באזור התחתון
בחר "Custom block"
הגדר את פורמט הבלוק ל-"Full HTML" או "Raw HTML"
הדבק את קוד ההטמעה של Asyntai בגוף הבלוק
תן לבלוק כותרת (למשל, "Asyntai Chatbot") ואופציונלית סמן "Hide title"
לחץ על "Save block" ואז "Save layout"

חשוב: ודא שפורמט הטקסט מוגדר ל-"Full HTML" או "Raw HTML" כדי שתג הסקריפט לא יוסר. פורמט "Filtered HTML" של ברירת המחדל יסיר תגי סקריפט מסיבות אבטחה.

שלב 3: נקה מטמון ואמת

לאחר ביצוע השינויים שלך, נקה את המטמון של Backdrop CMS ואמת את ההתקנה:

עבור ל-Configuration > Performance בפאנל הניהול שלך
לחץ על "Clear all caches"
פתח את האתר שלך בלשונית דפדפן חדשה או חלון גלישה פרטית
אתה אמור לראות את כפתור ווידג'ט הצ'אט בפינה הימנית התחתונה
לחץ עליו כדי לוודא שהוא נפתח ועובד כראוי

לא רואה את הווידג'ט? ודא שניקית את המטמון של Backdrop CMS ב-Configuration > Performance. נסה לצפות באתר שלך בחלון גלישה פרטית או נקה את מטמון הדפדפן. פתח את קונסולת הדפדפן (F12) כדי לבדוק שגיאות JavaScript. אם השתמשת בשיטת המודול המותאם אישית, ודא שהמודול מופעל תחת Functionality.